The Arsenal Files 8/The Arsenal Files Collection #8 (Arsenal Computer) (1996).ISO/windows/drgtxt20.zip/DRGTXT20.003

OS/2 Help File | 1996-11-30 | 65KB | 1,938 lines

ΓòÉΓòÉΓòÉ 1. Getting Started ΓòÉΓòÉΓòÉ

Basic Features
DragText's Basic features add drag-and-drop text features to many commonly used
windows:  entryfields, listboxes, etc.  With DragText, you can copy or move
text between these windows using drag-and-drop, delete text by dragging it to
the Shredder, and enter a filename by dropping the file's icon into a window.
The Basic features are offered without charge and require no registration.

Extended Features
DragText's Extended features provide seamless integration of text with files,
directories, Url objects, VIO (command-line) windows, and the Clipboard.

Drag text to a Workplace folder to create a file whose title is derived from
the text.  If the dragged text is a URL, DragText will create a Url object.
Drop DragText files and Url objects on any supported window to recover the
text.  You can drop a file from any source on a multiline entryfield, VIO
window, or the Clipboard to insert its contents.

The Extended features include two optional WPS classes to provide additional
services.  DTClip offers a drag and drop interface for the clipboard.  You can
use the object's icon directly, or open it to display a window that can be used
as a clipboard viewer and editor. DTFile permits you to append text to an
existing DragText file by dropping it on the file's icon.

The Extended features also include support for VIO windows via their existing
clipboard interface.  Full support for mouse-initiated marking, copying, and
pasting is provided.

The Extended features are offered as shareware and require registration to
prevent them from becoming disabled after your 6-week free trial ends. See the
section on Registration details.

Compatibility
DragText's features work with many commonly used applications, such as the
System Editor (e.exe) and most programs in the Internet Access Kit. It is
designed to add these features only to windows which lack them. It should never
replace or interfere with the drag-and-drop support provided by your
applications.

Because its features are added-on, not built-in, it may not work for every
possible window and conflicts may arise between DragText and some programs. If
a conflict occurs, DragText can be partially or totally disabled for that
program using the Disable page in the Options Notebook.

New and Revised Features in v2.0
Installation / Removal
Running DragText
Using DragText
Options Notebook
Product Information


ΓòÉΓòÉΓòÉ 1.1. Installation / Removal ΓòÉΓòÉΓòÉ

Installation
The installation program (DTSetup.exe) will:

     move DragText's files to the directory of your choice
     create a program object for DragText.exe and put it (or a shadow) in your
      Startup Folder and/or on the Desktop
     offer you the option of installing two Workplace Shell classes that
      provide some of DragText's Extended features
     insert several entries in os2.ini to disable DragText for programs known
      to be incompatible, and
     display some information specific to your system.

 Removal
 To remove DragText from your system, you can either:

     run DTSetup and choose "Uninstall" to partially or completely remove it,
      or
     simply remove the program object from your Startup Folder to keep it from
      running.

 DragText's WPS classes can also be installed or removed using the Extended
 page of the Options notebook. If you uninstall part or all or DragText, you
 will have to restart your system to remove it from memory if it was previously
 loaded.

 Running DragText
 Using DragText
 Options Notebook
 Product Information


ΓòÉΓòÉΓòÉ 1.2. Running DragText ΓòÉΓòÉΓòÉ

The first time DragText.exe is run during a session, it loads itself into
memory, displays a copyright message for 3 seconds, and then terminates.
DrgTxt20.dll, which implements the drag-and-drop features, remains resident for
the rest of the session.  You will not see DragText in any list of windows or
tasks.

All supported windows created AFTER DragText.exe is run will provide
drag-and-drop; those created before will not (this is the primary reason for
putting DragText in your Startup Folder).

Running DragText again will bring up the Options Notebook which has pages that
let you:

     set options for the Basic features such as the default drag action
     configure the settings for the Extended features such as Files and Urls,
     Disable DragText for particular programs
     provide Info about supported windows and the icons and pointers DragText
      uses
     get DLL info such as usage and errors, and
     review Product Information and enter your registration number

 Installation / Removal
 Using DragText
 Options Notebook


ΓòÉΓòÉΓòÉ 1.3. Frequently Asked Questions ΓòÉΓòÉΓòÉ

   1. Q:  Why can't I move the DTClip icon?

      A:  Dragging from this icon drags the clipboard's contents, not the
      object. To move/copy/shadow it, have Shift and/or Ctrl pressed when you
      begin to drag it.  See Moving and Copying DTClip for additional ways to
      manipulate the icon.

   2. Q:  Why doesn't DragText show up on my window list or task list?

      A:  DragText is NOT a task, process or window, so it won't appear in
      these lists.  Once you load it into memory (by running DragText.Exe), it
      stays there until you reboot.  (If you use Pstat or Watchcat, you will
      see DrgTxt20.Dll is in the list of dll's that have been loaded.)

   3. Q:  I completely disabled DragText for program X, but I can still drop
      text into program X's window.  Why doesn't Disable work?

      A:  You can only disable DragText for windows where DragText controls
      drag and drop.  You can tell when it is in control because the mouse
      pointer will include the letters "DT".  If you've enabled DragText's
      file-creation feature, you cannot prevent other programs from reading
      files it creates.  In this case, program X is in control and will let you
      transfer text using a DragText file.

   4. Q:  I set up my mouse so the left button is the "drag button", like in
      Windows.  How come I can't drag any text?

      A:  All the windows that DragText supports use the left button to move
      the cursor and select text.  These functions completely override any drag
      function assigned to this mouse button.  IBM would have to rewrite the
      software for these windows to change this.  You can still use DragText to
      insert a file's name or contents into a window.

   5. Q:  I tried disabling DragText for a program that runs in a VIO window,
      but I can still drag and drop from that window.

      A:  DragText supports the window, not the program whose output appears in
      it.  When you run that program, choose the DragText item in the window's
      System menu, then turn off drag, drop, and/or mouse marking.  See VIO
      Options for details.

   6. Q:  Why doesn't DragText work for one particular window in my program
      when it works for all the others.

      A:  There are at least two possible reasons:

          your program already supports drag and drop for this window;  since
           drag and drop isn't a visible feature, you may be unaware of it;
          the program may have installed some sort of special handling for
           this window that completely bypasses DragText.

   7. Q:  How do I change the default icon for DragText files?

      A:  If you chose to install the "DTFile" WPS class, create an icon file
      named "MYFILE.ICO" and put it in your DragText directory.

   8. Q:  The Settings notebook for a DragText file shows three entries under
      "Current types".  Are they necessary?

      A:  Yes.  The first (",Plain Text," with commas before and after) works
      around an incompatibility between the Workplace Shell and the system's
      drag and drop functions. The second ("Plain Text") associates these files
      with your editor;  it also avoids problems when using System Editor.  The
      third ("DragText") is used by the DTFile class and by DragText itself to
      identify these as DragText files.

 Getting Started
 Running DragText
 Using DragText
 Options Notebook
 Product Information


ΓòÉΓòÉΓòÉ 1.4. New and Revised Features in Version 2.0 ΓòÉΓòÉΓòÉ

This version of DragText has been designated v2.0 because of a major revision
in its architecture that enables it to support windows that are derived from
those supported by previous versions (v1.x).

New Features

     VIO (text-mode) window support via the clipboard. Mouse-initiated text
      marking is included.  Support for drag and drop and mouse-marking can be
      enabled/disabled from the window's System menu.  (See VIO Windows)

     A WPS-based Clipboard object that operates like a DragText-enabled
      window.  The object can be opened to display a floating clipboard viewer
      and editor. (See DTClip)

     Drop text or a file on an existing DragText file to append it to the
      existing text.  (See DTFile)

     Open program objects by dropping text on them.

     Print dragged text by dropping it on a printer object.

     Install and remove DragText's WPS classes from within its Options
      Notebook.  (See Install/Remove WPS Classes)

 Revised Features

     Temporary files are handled differently than in prior versions and their
      creation is now the default.  They must be enabled to open objects, print
      text, and drop text on windows that won't accept dragged text but will
      accept a file. The "create a pipe" option has been removed.

      Creating a DragText file when this option is enabled will cause the WPS
      to display a Copy dialog if you have its "Confirm on move, copy, shadow"
      option set.  The file name shown will be that of the temp file.  However,
      the copied file will have the standard DragText-style file name.

     The DTFile WPS class now supports templates and the "Create Another"
      option on each object's context menu. A default template that is
      deleteable is created when you register the class.

     Unreadable entryfields (i.e. those which display asterisks rather than
      text) can no longer be dragged from.  DragText now honors this attempt at
      providing security.

     Url object titles no longer include any periods. They are removed to
      prevent the system from misidentifying part of a Url as a file extension.

     The Options Notebook has been revised to accommodate the new features.
      There is now a separate side-tab for files in the "Extended" section of
      the notebook.  Please note that there are two pages associated with this
      tab. Use the page buttons to access the second page.

     Entering registration info causes all Extended features to be turned on
      when you reopen the Options notebook. Formerly, these had to be reenabled
      manually.  You must still close the notebook, then run dragtext.exe again
      to put your registration in effect.

 Getting Started
 Running DragText
 Using DragText
 Options Notebook
 Product Information


ΓòÉΓòÉΓòÉ 2. Using DragText ΓòÉΓòÉΓòÉ

When all features are enabled, DragText lets you use drag and drop to

     copy, move, or delete text
     create files and Url objects
     insert the contents of files and Url objects in supported windows
     create a formatted listing of a folder's directory
     append text to existing DragText files
     copy text to and from the clipboard

 To help you identify the results from a drag and drop operation, DragText uses
 up to six icons and three pointers.  These results can be changed by using
 modifier keys or by setting DragText's default actions to suit your needs.
 All of this is explained in detail in the following sections.

     Text, Urls, Files, and Folders

     Icons and Pointers

     Modifier Keys and Defaults

     Supported PM Windows

     VIO Windows

 Basic Features Overview
 Extended Features Overview
 Workplace Shell Classes
 Getting Started
 Running DragText


ΓòÉΓòÉΓòÉ 2.1. Text, Urls, Files, and Folders ΓòÉΓòÉΓòÉ

Dragging Text
To drag text out of any supported window , highlight it, then begin dragging
from anywhere within the window. You do not have to point at the selection nor
does it have to be visible (e.g. in an MLE, you can scroll it out of view).
(Note: for single-line Entryfields begin dragging without any highlighting to
drag the entire contents of the field.)

As you move the pointer over different windows, the icon and pointer will
change to indicate what will happen if you drop the text at that point. For
DragText-enabled windows, the text will be inserted into editable fields and
matching text will be selected in listboxes and readonly spinbuttons (see
restrictions below). You can delete text by dragging it to the Shredder.

When the Extended features are enabled, dropping text into a Workplace folder
will create a file, or a Url object if the text was a Url.

You may also be able to insert text into a window that is not DragText-enabled
if the program permits you to drop a file on it.  In this case, DragText's
"create a file" icon will be visible, not its "insert text" icon. You must have
the Temporary Files option turned on for this to be successful.

Dragging Files and Folders
With the Basic features, you can drop a file or folder into any supported
window to insert its fully-qualified name.  Using the Extended features, you
can drop a DragText-created file into any window to insert its text.  You can
also insert the contents of any file into a multiline entryfield by pressing
Alt before you drop it.  Press Alt before you drop a folder to insert a
formatted listing of its directory.  The formatting is controlled by the
settings on the Directory Options page (Files->Dirs) of the Options notebook.

Restrictions:  While you can copy text from any supported window , you can only
move or delete text from editable windows (i.e. those which aren't read-only or
listboxes).  Similarly, you can only move text into editable windows.  To
comply with CUA standards, you cannot copy text onto itself;  you can override
this by pressing Ctrl before you drop. Also, you can only drop one file icon
into a window at a time.

Using DragText
Icons and Pointers
Modifier Keys and Defaults


ΓòÉΓòÉΓòÉ 2.2. Icons and Pointers ΓòÉΓòÉΓòÉ

DragText uses mouse pointers to indicate whether DragText itself controls what
will happen.  If it is in control, DragText will change icons as you drag to
show what will happen if you make a drop.  When your drop creates a new file,
DragText assigns the file a default icon.

Pointers
Whenever you drag text or a file over a window that DragText controls, the
mouse pointer will always include the letters 'DT', and DragText will decide
whether a drop is permitted.  If the pointer does not say 'DT', the program
that owns the window is in control and it determines whether a drop is
acceptable.  In this case, there is nothing DragText can do to prevent the
program from accepting a drop.

DragText uses three pointers:

           Insert - text will be inserted into editable fields; text will be
           matched and selected in listboxes and spinbuttons
           Replace - used only for single-line entryfields to indicate that
           dropped text will completely replace the current contents.  Press
           and release the Insert key in a normal fashion to toggle between
           insert and replace.
           Illegal - DragText will not permit a drop

 Drag Icons
 With all Extended Features enabled, DragText switches among six different
 icons. If only the Basic Features are enabled, it uses two.  This feature is
 disabled if you have one of the original versions of OS/2 Warp v3.0 because of
 a bug in them (see Change Icons for more information).

 DragText uses these icons:

           Text - text will be inserted into editable fields; matching text
           will be selected in listboxes and readonly spinbuttons [Basic and
           Extended features]. This icon is also used when you drag a
           DragText-created file over any DragText-enabled window [Extended
           features].

           Note:  if Change Icons is disabled, this is the only icon that will
           be used.
           File - this icon never appears over a DragText-enabled window.  Over
           the Workplace Shell, a drop will create a file; elsewhere, text will
           be transfered to the target program via a file [Extended features].

           Url object (not shown here) - if the text you are dragging is a URL,
           this icon appears after you leave a DragText window.  Over the
           Workplace Shell, a drop will create a WPS Url object; elsewhere,
           text will be transfered to the target program via a file [Extended
           features].
           File Name - when you drag a file or folder over a DragText window,
           this icon replaces the original to show that the file or folder's
           fully qualified name will be inserted [Basic and Extended features].
           File Contents - appears only when dragging a file over a multiline
           entryfield (you may have to press the Alt key).  The file's contents
           will be inserted [Extended features].
           Folder Contents - appears only when dragging a folder over a
           multiline entryfield (you must press the Alt key).  A listing of the
           folder's contents will be inserted [Extended features].

 File Icon
 The default icon assigned to files DragText creates is the same as the file
 icon shown above.  To avoid wasting disk space, DragText files share a single
 icon which is supplied by the DTFile WPS class.  You can change the default to
 an icon of your choice by creating an icon file named "MYFILE.ICO" and putting
 it in your DragText directory.

 Using DragText
 Text, Urls, Files, and Folders
 Modifier Keys and Defaults


ΓòÉΓòÉΓòÉ 2.3. Modifier Keys and Defaults ΓòÉΓòÉΓòÉ

Modifier Keys
DragText uses standard modifier keys and adds two others to override the
default action.  Except for the Insert key, press and hold them before you
drop, NOT when you begin a drag.  For Insert, press and release immediately
while over an entryfield;  do NOT hold it down.

Ctrl

     copy text and DragText files
     copy text onto itself
     for files, insert the file's formatted directory entry rather than its
      fully-qualified name (this usage may change in future versions)

 Shift

     move text
     copy a DragText file then delete it
     you can never move folders or files from other sources

 Alt

     over MLEs, VIO windows, DTFile and DTClip objects, insert a file's
      contents
     over MLEs, VIO windows, DTFile and DTClip objects, insert a folder's
      directory listing

 Insert

     over a single-line entryfield or a DTClip object's viewer window, toggle
      between inserting the dropped text into the current contents, and
      replacing the current contents with the dropped text.

 Defaults
 In all cases, the default operation is Copy.  You can change these defaults:

 On the Options page

     copy/move text within a window
     copy/move text between windows
     insert/replace text in entryfields

 On the File Handling page:

     copy/move text from a window into a DragText file
     copy/move a DragText file into a window
     insert a file's name/contents into MLEs, etc.

 Using DragText
 Text, Urls, Files, and Folders
 Icons and Pointers
 Basic Features Overview
 Extended Features Overview


ΓòÉΓòÉΓòÉ 2.4. Supported PM Windows ΓòÉΓòÉΓòÉ

DragText works with six commonly-used types of windows found in most every
application.  They may be used as the app's main window, or only in its dialogs
and notebooks.  An example of each window appears on the Info page in the
Options Notebook

DragText also supports VIO (command-line) windows as an Extended feature. Refer
to VIO Windows for details.

Entryfield
usually contains a single piece of information, such as a filename.

     to drag the entire contents, don't highlight any text, just drag
     to replace the entire contents, quickly press and release the Insert key
      while over the field.  The mouse pointer will change to show that you're
      in Replace mode.

 Note:  You can not drag text from "unreadable" entryfields (those which
 display asterisks rather than text).  You can still drop text on them.

 Multi-line Entryfield
 often used as the main text window in simpler apps such as the System Editor.

     insert the contents of any file by pressing the Alt key before you drop
      the file's icon.
     enter a formatted listing for a directory by pressing the Alt key before
      you drop the folder's icon (see Directory Listing Options for details).

 Listbox
 dropping text will cause DragText to search for a matching item. If found, it
 will be selected (highlighted); if not, you'll hear a beep. DragText will
 never insert text into a listbox.

 Combobox
 combines an entryfield with a listbox.  DragText handles each part as if it
 were a stand-alone window, with one exception. If the entryfield is read-only,
 dropping text on it will cause a search of the listbox for a matching entry

 Spin Button
 combines an entryfield with a button.  If the entryfield part can be edited,
 it will be handled like a stand-alone entryfield.  If it is read-only,
 DragText will search for a matching item. If found, it will be displayed;
 otherwise, you'll hear a beep.

 Static Text
 used to display text that can't be edited, such as labels and error messages.
 You can drag text from static text windows but you can never drop anything on
 them.

 Note:  You should be aware that some programs create their own window-types
 that closely resemble the standard ones.  DragText may not support these
 look-alikes.

 VIO Windows
 Getting Started
 Using DragText
 Options Notebook


ΓòÉΓòÉΓòÉ 2.5. VIO Windows ΓòÉΓòÉΓòÉ

Sometimes referred to as "text-mode" or "command-line" windows, VIO windows let
OS/2 and DOS programs that were designed to use the full screen run on the
Desktop in a window.  Support for these windows is one of DragText's Extended
features

Because the internal functioning of VIO windows is entirely undocumented,
DragText must rely on their existing clipboard interface to move text in and
out of them.  This is the only type of window where DragText uses the
clipboard.  For all other supported windows windows, its operations are
completely independent of the clipboard.

Refer to these sections for details on using DragText in VIO windows:

     Using Drag and Drop

     System Menu Options

     Mouse Marking

     Disabling DragText

 Setting VIO Options
 Supported PM Windows
 Getting Started
 Using DragText
 Options Notebook


ΓòÉΓòÉΓòÉ 2.5.1. Using Drag and Drop in VIO Windows ΓòÉΓòÉΓòÉ

Drag
Select the text to be dragged using either DragText's marking feature or
another similar facility, then begin dragging.  The text will be copied to the
clipboard where DragText can access it and handle it like text from any other
window.

Drop
Text dropped on a VIO window is first copied to the clipboard, then pasted into
the window at the current cursor location. For some OS/2 text-mode apps that
offer mouse support, the cursor may move to the drop location.  Dropping a file
inserts either its name or contents;  you can set the default on the
Extended->File Handling Options page in DragText's Options notebook (page 2 of
the Files section).

VIO Window Overview
System Menu Options
Mouse Marking
Disabling DragText
Setting VIO Options


ΓòÉΓòÉΓòÉ 2.5.2. System Menu Options in VIO Windows ΓòÉΓòÉΓòÉ

DragText adds a new entry to the System Menu for VIO windows.  Choosing it
displays a submenu that lets you turn these features on or off for that window
only:

     Mouse Marking
     Drag
     Drop

 The initial settings for each window are controlled by the Extended->VIO
 Options page in DragText's Options notebook.

 VIO Window Overview
 Using Drag and Drop
 Mouse Marking
 Disabling DragText
 Setting VIO Options


ΓòÉΓòÉΓòÉ 2.5.3. Mouse Marking in VIO Windows ΓòÉΓòÉΓòÉ

DragText provides a mouse-initiated marking feature that operates similarly to
that included in Warp v4.0 but is somewhat more flexible.  You can choose
whether to use mouse button 1 or 3 for marking, and whether a specific key must
be pressed for it to become active.  These options are set using the
Extended->VIO Options page in DragText's Options notebook.

The only mouse action needed to use DragText is Mark.  However, for your
convenience, all of the standard mouse actions are supported:

 Mark      Press MB1 or MB3, then start moving the mouse.  When you release the
           button, the text will remain marked, ready for it to be dragged.
 Copy      While marking (i.e. while MB1 or 3 is still down), press MB2.  The
           marked text will be copied to the clipboard and the highlighting
           will be removed.
 Paste     Press MB1 (or MB3) and MB2 at the same time.  The current contents
           of the clipboard will be pasted at the cursor location (not at the
           mouse pointer).

 VIO Window Overview
 Using Drag and Drop
 System Menu Options
 Disabling DragText
 Setting VIO Options


ΓòÉΓòÉΓòÉ 2.5.4. Disabling DragText in VIO Windows ΓòÉΓòÉΓòÉ

DragText provides support for the window, NOT the program running in the
window.  You cannot disable DragText for specific apps that run in a VIO
window.  If you encounter problems, you can disable it in either of two ways:

     from the Extended page of DragText's Options notebook so that it cannot
      be turned on for any window, or
     from the Extended->VIO Options page so that it can be turned on for
      selected windows from their System Menu.

 VIO Window Overview
 Using Drag and Drop
 System Menu Options
 Mouse Marking
 Setting VIO Options


ΓòÉΓòÉΓòÉ 3. Options Notebook ΓòÉΓòÉΓòÉ

Whenever you need to change DragText's defaults or get help on using it, run
DragText to open its Options Notebook.  There are four major sections, each
with a tab at the top of the notebook:

  Basic       set the default actions for DragText's Basic features.

  Extended    set the default actions for DragText's Extended features.

  Disable     restrict DragText's operation for any programs you specify.

  Info        get quick help, review error messages, enter your registration

 All settings take effect as soon as you press the "Apply" button, change pages
 in the notebook, or close it.


ΓòÉΓòÉΓòÉ 3.1. Basic Features ΓòÉΓòÉΓòÉ

The two Basic pages let you set the default actions for DragText's Basic
features. All settings take effect as soon as you press the "Apply" button,
change pages in the notebook, or close it.

Drag Defaults
Background Drag
Reset Notebook
Icons and Pointers
Other Options


ΓòÉΓòÉΓòÉ 3.1.1. Drag Defaults ΓòÉΓòÉΓòÉ

Between Windows
when dragging text from one window to another, this determines whether the
default action will be to copy or move the text

Within a Window
when dragging text from one part of a window to another, this determines
whether the the text will be copied or moved

These defaults can be overridden by pressing the Ctrl key (to copy) or the
Shift key (to move).

Note:  In many situations, a move operation is not possible.  If the default is
set to move, the text will be copied instead. If you explicitly request a move
by pressing the Shift key, the operation will be refused.

Drops into entryfields
When you drop text from another window into an entryfield (or the entryfield
portion of a combobox or spin button), you can choose to have it:

     inserted into the existing text (the initial setting)
     completely replace the existing text (the recommended setting)

 When set to insert, DragText's 'I-beam' mouse pointer will be used.  When set
 to replace, the mouse pointer will change to an I-beam followed by three X's.
 (See Icons and Pointers ) In use, press and immediately release the Insert key
 while over an entryfield to toggle between insert and replace.  You must be
 over a DragText-enabled window when you press Insert to avoid changing the
 system's global insert state.

 Basic Features Overview
 Background Drag
 Reset Notebook
 Icons and Pointers
 Other Options


ΓòÉΓòÉΓòÉ 3.1.2. Background Drag ΓòÉΓòÉΓòÉ

This option keeps a DragText-enabled window from coming to the top when you
press mouse button 2 ("MB2", usually the right-hand button).  Enabling this
feature will prevent the source of a drag from covering the intended target.
Your choices are:

     never:  this feature is disabled
     always:  this feature is enabled
     Ctrl+MB2 only:  this feature is active only when you press and hold the
      Ctrl key as you press mouse button 2

 You can disable this feature on a program-by-program basis using the Disable
 page.

 Important:

     This option affects all MB2 actions in DragText-enabled windows. If the
      window has a popup menu, clicking MB2 will display the menu on top of all
      other windows but the window itself will remain partially covered.
     You can perform a drag even if the highlighted text is completely
      covered. Begin dragging from whatever portion of the window is visible.
     Some utility programs that add new functions to the mouse buttons may
      interfere with this DragText feature.

 Basic Features Overview
 Drag Defaults
 Reset Notebook
 Icons and Pointers
 Other Options


ΓòÉΓòÉΓòÉ 3.1.3. Reset notebook to default size ΓòÉΓòÉΓòÉ

Each time you close the Options Notebook, DragText saves its current size,
position, and display attributes (e.g. the font used for notebook tab text).
Use this checkbox to restore all of these to their default values the next time
you run DragText.exe.  This is particularly useful if you change display
resolutions.

Basic Features Overview
Drag Defaults
Background Drag
Icons and Pointers
Other Options


ΓòÉΓòÉΓòÉ 3.1.4. Icons and Pointers ΓòÉΓòÉΓòÉ

Pointer Size
You can choose whether DragText uses Normal sized I-beam  and Illegal  mouse
pointers or Large ones that may be more appropriate for high-resolution
displays.

Change Icons
This controls whether DragText automatically determines if it is safe to change
the icon as you drag text or files over a DragText-enabled window. See below
for a detailed explanation.  Your choices are:

     auto-detect:  DragText will perform the check described below.  This is
      the default.
     yes:  change icons, regardless of the build level.
     no:  do not change icons, regardless of the build level.

 Details
 When you drag text or files over a DragText window, DragText can change the
 dragged icon to identify what will happen if you drop it.  However, a bug in
 all of the original releases of OS/2 Warp v3.0 will cause the source
 application to crash if this feature is enabled.  The problem can be corrected
 by installing Warp Fixpack 8 or later (Fixpack 22 was the latest available, as
 of October, 1996).  It is also fixed in v4.0.

 At startup, DragText examines the "buildlevel" of PMMERGE.DLL to see if this
 fix is installed and then enables or disables this feature accordingly.  The
 results of its findings are displayed here (either auto-detect = yes or
 auto-detect = no). If DragText misidentifies the buildlevel, you can override
 it with this setting. To identify the buildlevel yourself, enter "ver /r" at
 an OS/2 command prompt. This feature should be enabled if the buildlevel is
 8.232 or higher.

 Cache Icons
 DragText doesn't load an icon until it is needed.  It can then save it for
 later use or it can delete it to free up memory.  Unless you run many programs
 simultaneously and are short of memory, you should probably leave caching
 enabled.

     yes:  leave icons in memory; this is the default.
     no:  delete the icon after use; this will free all icons, including those
      previously cached.

 Basic Features Overview
 Drag Defaults
 Background Drag
 Reset Notebook
 Other Options


ΓòÉΓòÉΓòÉ 3.1.5. Other Options ΓòÉΓòÉΓòÉ

Hilite Dropped Text
When set to yes, DragText will highlight the text you drop into an editable
window.  This permits you to repeatedly copy the same text, and makes it easier
to move or delete text dropped in error.

Error Notification
This determines whether DragText notifies you when it encounters an error. When
set to beep, DragText will make a distinctive two-note beep. This is the
initial and recommended setting.  When set to None, DragText will not notify
you.

In any case, the most recent error message can be viewed on the DLL Info page.

Startup Delay
If keeping DragText in your Startup Folder causes problems (e.g. the Desktop
hangs), you can have DragText pause before installing itself.  Giving the WPS
and other programs time to finish their initialization should eliminate any
conflicts.

Set this to None if you're not having problems.  Otherwise, see how many
seconds pass from the time objects in your Startup Folder are run until your
disk drives cease most activity.  Then select an equivalent Startup Delay.  For
most systems, this should be 10 to 30 seconds.

Basic Features Overview
Drag Defaults
Background Drag
Reset Notebook
Icons and Pointers


ΓòÉΓòÉΓòÉ 3.2. Extended Features ΓòÉΓòÉΓòÉ

The six pages under the Extended tab let you set the default actions for
DragText's Extended features.  These features require registration for use
after your 6-week trial period end.

All settings take effect as soon as you press the "Apply" button, change pages
in the notebook, or close it.

Enable Extended Features
Workplace Classes
File Creation Options
File Handling Options
Directory Listing Options
Url Options
VIO Options


ΓòÉΓòÉΓòÉ 3.2.1. Enable Extended Features ΓòÉΓòÉΓòÉ

Enable all or parts of DragText's Extended features systemwide.

Files
Create files by dropping text on a folder or the Desktop.
Read files and directories by dropping them on any supported window or object.
This feature can be disabled for specific programs using the Disable page.

Url objects
DragText will create a Url object or file if the text you drop on a folder or
the Desktop is recognized as a Uniform Resource Locator. DragText will remove
any embedded spaces and newline characters, and will assign the object or file
a name based on the Url.  If this feature is disabled, DragText will handle
Urls like any other dragged text.

VIO windows
Text can be dragged from VIO (text-mode) windows and text or files can be
dropped onto them. Unlike any other windows, DragText must use the clipboard to
accomplish this.  Each drag or drop involving a VIO window will overwrite the
current contents of the clipboard.  To make marking VIO text easier, DragText
offers a mouse-initiated marking feature similar to Warp v4.0 but somewhat more
flexible.

Clipboard Object
If the DTClip class is registered, the clipboard object it creates can be used
like any other DragText-enabled window.  You can either use the object's icon
to drag and drop text to and from the clipboard, or you can open it to display
a window that can be used as a clipboard viewer and editor.

DTFile append
If the DTFile class is registered, text or a file can be dropped on a DragText
file to append it to the existing contents.

Extended Features Overview
Workplace Classes


ΓòÉΓòÉΓòÉ 3.2.2. Install/Remove Workplace Classes ΓòÉΓòÉΓòÉ

DragText uses two Workplace Shell classes, DTFile and DTClip,  to provide some
of its Extended features. These classes can be installed or removed at any
time, regardless of whether any Extended features are enabled.

When you turn to the Extended page, DragText checks to see if each class is
currently registered. It then sets the button next to each name accordingly,
either to Install or Remove

Install
DragText will attempt to register the corresponding WPS class.  For DTClip, it
will also attempt to create a Clipboard Object on the Desktop named "DTClip".
When complete, it will display a popup message window that says whether it
succeeded or failed.

If installation succeeds, the button will change to Remove. You may have to
restart your system for existing DragText files to acquire the new features
provided by DTFile.  This should not be necessary for DTClip.  Also, be sure
the features provided by these classes are enabled in the Enable Extended
Features section of the Extended page.

If installation fails, the button may still change to Remove. If so, you should
press it again so that Install reappears. The most likely reason for failure is
that DTFile20.Dll or DTClip20.Dll could not be found in your DragText directory
(all of DragText's program files must be in the same directory as
DragText.Exe).

Remove
DragText will display a message explaining what it is about to do, and will ask
for confirmation.  If you press OK, it will attempt to remove the corresponding
WPS class.  For DTClip, it will first try to delete the Clipboard Object it
created when you installed this class. For DTFile, it will not delete any
files. When complete, it will display a popup message window that says whether
it succeeded or failed.  It is very unlikely that this will fail.  For DTFile,
you may have to restart your system to remove it from memory.

Recreating the Clipboard Object
If you need to recreate your Clipboard Object (perhaps because you accidentally
deleted it), simply remove the DTClip class, then install it again.

Workplace Shell Classes
DTFile
DTClip
Extended Features Overview
Enable Extended Features


ΓòÉΓòÉΓòÉ 3.2.3. File Creation Options ΓòÉΓòÉΓòÉ

File and Url Titles
DragText files are given meaningful names based on the first few words of the
text.  Url objects' names are based on the Url itself.  These options control
how the will be formatted.

Lines:  the maximum number of lines the title will use when displayed in a
Workplace folder

Chars:  the maximum number of characters in each line

+/- Chars:  DragText can add or subtract this many characters to a line to
avoid splitting a word in two

Replace punctuation with:  this character will replace one or more consecutive
spaces, punctuation, and control characters in file titles (but not in Url
titles)

Temporary Files
These settings control whether DragText will create a temporary file every time
you begin dragging text.  A temporary file is NOT needed to drop text on a
folder or the Desktop to create a file.  It is needed to drop text on: programs
that will only accept a file; printer objects; and program objects (such as
editors) to open them.  Because DragText uses a separate thread to create its
temporary file, this shouldn't have a significant impact on overall
performance.

Create temp files:

     always:  this is the most reliable setting for transferring text via a
      file, and is the default setting.  However, there will be background disk
      activity whenever you begin dragging text.
     Urls only:  a temporary file will be created only if the text is
      recognized as a URL.  This lets you drop Urls on your Web browser icon to
      open the program and load the Url, but avoids disk activity for other
      types of text.
     never:  this is the best setting if your apps will accept dragged text
      directly and you don't need to drop text on Workplace objects other than
      folders.

 File Name:  the name DragText uses when creating a file for any text other
 than a Url; it is reused every time you begin a drag.  The name must conform
 to the 8.3 naming convention.  The default value is "DT_TEXT".

 Url Name:  the name DragText uses when creating a file for Url text; it is
 reused every time you drag a Url.  The name must conform to the 8.3 naming
 convention.  The default value is "DT_URL".

 Path:  the disk directory where the temporary file is stored.  The default
 value is the directory where DragText.Exe is stored.

 Note:  If "Create temp files" is enabled, and you have the Workplace's
 "confirm copy" option set, a confirmation dialog will appear whenever you drop
 text on a folder or the Desktop.  The file name shown will be that of the
 temporary file.  However, the copied file will have a name based on the text
 or Url.

 Extended Features Overview
 File Handling Options
 Directory Listing Options
 Url Options
 VIO Options


ΓòÉΓòÉΓòÉ 3.2.4. File Handling Options ΓòÉΓòÉΓòÉ

These options control how DragText will handle files dropped on supported
windows and objects.

DragText Files

Creating a file:  the text used to create a file can be either copied or moved
(i.e. deleted) from the source window.  Override the default by pressing Shift
to move or Ctrl to copy when you drop the text.

Dropping a DTFile:  when you drop a DragText file on a supported window, you
can either copy or delete (i.e. move) the file.  You can override the default
by pressing Shift to move or Ctrl to copy.

Other Files
When you drop a file DragText didn't create on one of these windows or objects,
DragText will insert either the file's complete name or the file's contents. If
it inserts the contents, DragText will replace all nulls with spaces and remove
any trailing end-of-file (Ctrl-Z) character.  You can toggle these settings by
pressing Alt when you drop the file.

Extended Features Overview
File Options
Directory Listing Options
Url Options
VIO Options


ΓòÉΓòÉΓòÉ 3.2.5. Directory Listing Options ΓòÉΓòÉΓòÉ

If you drop a Workplace folder on a multiline entryfield while pressing Alt,
DragText will insert a formatted listing of the files in that disk directory.
This listing will not include non-file objects (such as program objects or
shadows).  This feature can be used to create simple batch files, as shown in
Example 2 below.

Include
edit window:  like any request for a directory listing, this determines which
files will be included.  The default is "*"  which includes all files.  You
could change this to "*.exe" to include only programs, or to "a*" to include
only files whose names begin with the letter "a".

Flags:  this lets you include or exclude files based on their standard
attributes: Directory, Read-only, Archived, Hidden, and System.  Plus ("+")
includes files with that attribute while minus ("-") excludes files with the
attribute. Equal ("=") requires a file to have the attribute to be included.
The default value of all pluses includes all files.  Setting the flags to "+D
-R +A =H +S" would produce a listing of hidden files that weren't also
read-only

Listing Format
This sets the formatting for each file in the listing.  You can enter
meta-characters (see below), fixed text, tabs, and carriage returns.  (Note:
you must include a carriage return if you want each entry to appear on a
separate line.)  The default value is "%#  %d  %t %s %a %f" , followed by a
carriage return.  If you erase the contents of this field, DragText will fill
in the default value;  it cannot be left blank.

Heading Format
This produces a heading for your listing.  You may include fixed text, control
characters, and the meta-characters for the path and file.  The file
meta-character will be replaced by the search string.  If this field is left
blank, no heading will be produced.

Meta-Characters
These represent the various components of a directory listing:

 %p        pathname as it appears on the disk with both upper and lowercase
           letters
 %P        pathname with all letters converted to uppercase

 %f        filename as it appears on the disk with both upper and lowercase
           letters
 %F        filename with all letters converted to uppercase

 %n        filename without its extension with both upper and lowercase letters
 %N        filename without its extension with all letters converted to
           uppercase

 %e        filename extension with both upper and lowercase letters
 %E        filename extension with all letters converted to uppercase

 %d        file date (same as %D) using your country's standard format
 %D        file date (same as %d) using your country's standard format

 %t        file time as HH:MM (plus AM or PM if you use a 12-hour clock)
 %T        file time as HH:MM:SS (plus AM or PM if you use a 12-hour clock)

 %s        file size to a maximum of 7 digits;  if the size is 10 million or
           more, this field will contain 7 asterisks (i.e. "*******")
 %S        file size to a maximum of 10 digits

 %a        file attributes (including the directory flag) in lowercase letters
 %A        file attributes (including the directory flag) in uppercase letters

 %#        the sequence number of this entry, starting at 1

 %%        used to include a percent sign in your fixed text

 Note:  the pathname will not include a final backslash unless it is
 immediately followed by the filename

 Example 1 - verbose listing

  [Heading]  Directory listing for %p
  [Listing]  File %F was created on %d at %T

  [Output]  Directory listing for C:\DragText
        File DRAGTEXT.EXE was created on 12-25-95 at 01:10:00
        File DRAGTEXT.DLL was created on 12-25-95 at 01:10:00
        [etc.]

 Example 2 - creating a batch file

  [Heading]  cd %p
  [Listing]  ren %f %F

  [Output]  cd C:\DragText
        ren DragText.Exe DRAGTEXT.EXE
        ren DragText.Dll DRAGTEXT.DLL
        [etc.]

 Extended Features Overview
 File Options
 Url Options
 VIO Options


ΓòÉΓòÉΓòÉ 3.2.6. Url Options ΓòÉΓòÉΓòÉ

If this feature is enabled, DragText will create a Url object or file if the
text you drop on a folder or the Desktop is recognized as a Uniform Resource
Locator.

DragText will create a WPS object if either the WPUrl or WebExplorer_Url class
is registered.  Otherwise, it will create a file that is functionally identical
to an object, except for the class-specific settings notebook. Either can be
dropped on IBM's WebExplorer or other compatible Web browsers to load the Url.

Url Identifiers
When the beginning of your text matches one of these prefixes, DragText creates
a Url object.  The default values are "http:// ftp://" .  You can add any
identifier that your Web browser supports;  for example, you could add
"gopher://". Separate each identifier with a space.

DragText can also recognize incomplete Urls and fill in the missing identifier.
Enter the identifier surrounded by angle brackets ('<' and '>'), followed by
the letters DragText should try to match. The default values are "<http://>www.
<ftp://>ftp." .  Notice that each ends with a period:  this should keep
DragText from misidentifying sentences beginning with these letters.

Title Options
DragText uses these options, plus its own rules, to format the Url as a title.
They do not affect the object's contents.

Remove from Hostname:  to provide shorter and more meaningful titles, you can
have DragText remove unnecessary words from the hostname portion of the Url.
Each portion of the name, delimited by a dot or a slash, is compared to this
list;  if it matches, the word is eliminated.  The wildcard characters '*' and
'?' can be used.  The default values are "www* com net edu org ??" .  Using
"www*" will remove "www", "www1", "www-os2", etc.  Using "??" will remove all
two-letter words, such as country identifiers (e.g. "ca" or "de").

Line break after hostname:  when checked, only the hostname will appear on the
first line of the title. Any path information will begin on the second line.
If the hostname is long enough to wrap to line 2, no line break will be added.

Hostname only:  when checked, the Url title will include only the hostname.  No
path information will appear in the title.

Extended Features Overview
File Options
Directory Listing Options
VIO Options


ΓòÉΓòÉΓòÉ 3.2.7. VIO Options ΓòÉΓòÉΓòÉ

If VIO support is enabled, you can drag text and files into and out of these
windows, subject to the settings on this page.  For details on DragText's VIO
support, refer to VIO Window Overview

Options

Drag & Drop
Controls whether drag and/or drop is enabled for a VIO window when it is first
opened.  Each VIO window has a DragText item in its System Menu that lets you
change this setting for that window only.

Mouse Marking
Controls whether DragText's marking feature is enabled for a VIO window when it
is first opened.  Each VIO window has a DragText item in its System Menu that
lets you change this setting for that window only. Refer to Mouse Marking for
details on how this feature works.

Files
Controls whether files can be created using text dragged from VIO windows, and
whether existing files can be dropped in them to read the file's contents.
This is a global setting that affects all VIO windows.

Mouse Marking

DragText provides a mouse-initiated marking feature that operates similarly to
that included in Warp v4.0 but is somewhat more flexible.  DragText's marking
feature will usually override other marking utilities that use the same
combination of mouse buttons and keys.  Refer to Mouse Marking for details on
how this feature works.

Button
Controls which button will be used for marking text.  Your choices are:

     mouse button 1 - usually the left mouse button
     mouse button 3 - the middle button on a 3-button mouse

 Keyboard
 Controls whether particular keys must be pressed along with the mouse button
 for DragText's marking feature to become active.  This lets you avoid
 conflicts with both a VIO application's use of the mouse and with other
 marking utilities. Your options are:

     various combinations of Shift, Ctrl, and Alt - the selected key or keys
      must be pressed for DragText to take action

     no keys pressed - DragText will ignore the mouse action if Shift, Ctrl,
      or Alt are pressed

     ignore keyboard - DragText's marking feature will become active
      regardless of whether any keys are pressed.

 Remove last carriage return
 When checked, DragText will delete the carriage return that the system adds
 following the last line of text.

 VIO Window Overview
 Extended Features Overview
 File Options
 Directory Listing Options
 Url Options


ΓòÉΓòÉΓòÉ 3.3. Disable ΓòÉΓòÉΓòÉ

The Disable page lets you restrict DragText's operation for any Presentation
Manager-based programs you specify (e.g. System Editor).  You cannot disable it
for specific programs that run in a VIO (text-mode) window (e.g. TEdit).  If
necessary, you can disable it for a particular VIO window from that window's
System menu (refer to Enable Extended Features for details).

Normally, DragText is enabled for all programs.  However, if it conflicts with
an application's use of drag-and-drop, you can partially or totally disable
DragText for that program.

The "Program" section of the dialog contains a list of all applications that
currently have restrictions. The checkboxes under "Uncheck to Disable" show the
window types on which DragText operates.  If a box is checked, DragText is
enabled.

If DragText's Extended features are enabled, you can disable them for a
specific program. Uncheck Drag to disable file and Url object creation; uncheck
Drop to disable reading files, directories, and Url objects.

You can also disable Background Drag for specific programs.

Important:  you can only disable file operations for DragText-enabled windows.
These are windows where the mouse pointer changes to one of DragText's unique
pointers (see Icons and Pointers for details).  You cannot prevent a program
that accepts dropped files from accepting text rendered as a file or Url
object.  For example, if you drag a Url from a DragText window, you cannot
prevent IBM's WebExplorer from accepting it because DragText does not control
WebExplorer's drag and drop features.

Add a Program to the Restricted List
Change a Program's Restrictions
Remove a Program from the List

Notes:

     Restrictions are checked when a program is launched, not during its
      execution.  To add a restriction, close the application program, add the
      restriction, then restart the program.
     Only programs with restrictions are saved.  Programs whose settings match
      the default (no restrictions) will be dropped from the list and will not
      appear next time you run DragText.  This is done to enhance DragText's
      performance.

 Conflicts with Other Programs
 Disabling DragText System-wide
 Getting Started
 Using DragText


ΓòÉΓòÉΓòÉ 3.3.1. Conflicts with Other Programs ΓòÉΓòÉΓòÉ

DragText knows very little about the programs it works with and they know
absolutely nothing about DragText.  Because of this, conflicts are possible -
particularly with applications that have their own drag and drop functions.

DragText can usually tell when a program is handling drag and drop and avoids
getting involved.  When this fails, you may get an error message or unexpected
results.

To eliminate this problem, use the Disable page to disable DragText partially
or totally for that program.  It usually isn't necessary to disable DragText
totally;  in most cases, disabling the particular type of window that is
causing trouble will suffice.  You may find that disabling only drags or only
drops for that window will solve the problem.

Restrictions are checked when a program is launched, not during its execution.
To add a restriction, close the application program, add the restriction, then
restart the program.

Note:  Most error messages arise from other problems in the system and are not
directly the result of a conflict between DragText and your application
program.

Disable Overview
Running DragText


ΓòÉΓòÉΓòÉ 3.3.2. Add a Program to the Restricted List ΓòÉΓòÉΓòÉ

Enter the name of the program (or drop its icon into the entryfield).  Path
information is not needed and will be removed when you add this entry.

To disable drag and/or drop for particular window types, uncheck the
corresponding boxes.  To disable DragText entirely uncheck "All Windows".

Press the button labeled "Add".

Change a Program's Restrictions
Remove a Program from the List


ΓòÉΓòÉΓòÉ 3.3.3. Change a Program's Restrictions ΓòÉΓòÉΓòÉ

Select the program from the list.  The checkboxes will show its current status.

Make any necessary changes.

Your changes will be saved when you select another program from the list, press
the "Apply" button, change notebook pages, or exit.

Add a Program to the Restricted List
Remove a Program from the List


ΓòÉΓòÉΓòÉ 3.3.4. Remove a Program from the List ΓòÉΓòÉΓòÉ

Select the program from the list.  The checkboxes will show its current status.

Press the "Remove" button.  The entry will be deleted immediately.
-- or --
Check all of the checkboxes (i.e. so that there are no restrictions). The entry
will be deleted when you close the notebook.

Add a Program to the Restricted List
Change a Program's Restrictions


ΓòÉΓòÉΓòÉ 3.3.5. Disabling DragText System-wide ΓòÉΓòÉΓòÉ

DragText uses only documented features of OS/2 which should continue to be
supported in future versions. Still, it is possible that unforeseen changes to
the operating system will render DragText incompatible with a particular type
of window.  To retain the bulk of DragText's usefulness, you can disable that
window type system-wide.

On the Disable page, enter <ALL PROGRAMS> (the angle brackets are required).
Uncheck both boxes for this window type, then press the "Add" button.  This
option will be in effect for all newly launched programs;  those which are
already running will not be affected.

In extraordinary circumstances, you may find it necessary to disable DragText
for all new windows in all programs.  To do this, follow the instructions
above, but uncheck both boxes next to "All Windows".  In this case, DragText
will be disabled for all new windows, including those created by programs that
are already running.  Windows that already exist will not be affected.


ΓòÉΓòÉΓòÉ 3.4. Info ΓòÉΓòÉΓòÉ

The four Info pages provide information about DragText's usage and current
status.  They contain no settings except for a place to enter your
registration.

  Info     practice your drag and drop using examples of each supported window

  Icons    view each of the icons and pointers used as you drag text and files

  DLL      review usage statistics and error messages

  DT       enter your registration number, review product info


ΓòÉΓòÉΓòÉ 3.4.1. DLL Info ΓòÉΓòÉΓòÉ

The DLL Info page provides usage and error statistics for Drgtxt20.dll.

Usage
The usage section shows the number of processes (programs) that have loaded
Drgtxt20.dll and the number currently using it. The latter figure will usually
be at least 3 (two instances of pmshell.exe and DragText.exe itself).

Errors
This section displays the total number of errors encountered during this
session, the ID number of the last process to have an error, and the message
associated with that error.

When an error occurs, Drgtxt20.dll will notify you if you choose this option on
the Basic Features-> Misc page.  You can restart DragText.exe and refer to this
page to review the error message.

Note:  These messages are intended for debugging and diagnostic purposes.
Except for identifying conflicts with other programs, they are of little use to
the user.  All errors arise from flaws in DragText, other applications, or the
operating system. Users cannot "cause" errors.

Conflicts with Other Programs
Basic Features Overview
Getting Started


ΓòÉΓòÉΓòÉ 3.4.2. Registration Information ΓòÉΓòÉΓòÉ

After you register DragText you will receive a registration number.  Enter it
on the last page (Info->DT) of the Options Notebook.  Enter your name exactly
as it appears on your registration notice.  Close the notebook, then reopen it
to reset your options.

Product Information
Registering DragText
License Agreement
Options Notebook


ΓòÉΓòÉΓòÉ 4. Workplace Shell Classes ΓòÉΓòÉΓòÉ

DragText uses two Workplace Shell classes, DTFile and DTClip, to provide some
of its Extended features.  Except for the features described below, DragText
does not rely on the WPS and operates very well on systems where the WPS is not
used.

DTFile

     permits appending text to an existing DragText file without having to
      open it
     assigns DragText files a unique icon that identifies them

 DTClip

     provides a drag and drop interface for the clipboard

 DragText must be loaded and the Extended features provided by these classes
 must be enabled before you can use them.  DTClip and DTFile can be installed
 or removed at any time, regardless of whether any Extended features are
 enabled.  If your free trial period for the Extended features has expired and
 you haven't registered DragText, you should remove these classes to save
 memory.

 Install/Remove WPS Classes
 DTFile
 DTClip
 Using DragText


ΓòÉΓòÉΓòÉ 4.1. DTFile ΓòÉΓòÉΓòÉ

Files created by DragText become DTFile objects if this WPS class is installed.
Unlike a standard data file, you can drop text or another file on a DTFile's
icon to append the new text to the end of the existing text. DragText must be
loaded before you can use the append feature.  To identify them, DTFile objects
share a default icon that doesn't change, regardless of any program
associations.  You can replace this default icon with another if you wish.

For additional information, refer to:

     Changing the DTFile Icon

     Using DTFile Append

     DTFile Append Options

 Using DragText
 Workplace Shell Classes
 Install/Remove WPS Classes


ΓòÉΓòÉΓòÉ 4.1.1. Changing the DTFile Icon ΓòÉΓòÉΓòÉ

To replace DTFile's default icon, create an icon file named MYFILE.ICO and
place it in your DragText directory (i.e. the same directory as DTFILE20.DLL).

DTFile Overview
Using DTFile Append
DTFile Append Options
Install/Remove WPS Classes


ΓòÉΓòÉΓòÉ 4.1.2. Using DTFile Append ΓòÉΓòÉΓòÉ

Drop text or a file on a DTFile's icon to add it to the file. The new text will
be joined to the existing text according to the append options you select.
Refer to DTFile Append Options for a complete description.

Important:  When dropping text or a file on an object's icon, the mouse pointer
and the dragged image will not change the way it would over a DragText-enabled
window.  However, standard DragText actions, such as pressing Alt to insert a
dropped file's contents, will still work.

DTFile Overview
Changing the DTFile Icon
DTFile Append Options
Install/Remove WPS Classes


ΓòÉΓòÉΓòÉ 4.1.3. DTFile Append Options ΓòÉΓòÉΓòÉ

Each DTFile object has two pages in its WPS notebook that control the way text
or a file dropped on a DragText file icon will be joined to the existing text.
The first page controls options for that file only. The second page sets
system-wide options for all DTFile objects.

Existing Text
Controls whether any blank space following the existing text will be removed.
Null and end-of-file characters will always be removed, regardless of this
setting.  Your choices are:

     remove trailing blank lines - lines containing only spaces, tabs, and
      newline characters will be deleted.  The last line of text will not be
      affected.
     remove trailing whitespace - all spaces, tabs, and newline characters
      after the last printable character will be deleted.  This is the default.
     do not edit - the file will be left as-is, except for trailing null and
      end-of-file characters.

 Separator
 Controls what text, if any, should be placed between the file's existing
 contents and the newly added text.

 edit window:  enter your separator text here exactly as it should appear in
 the file.  Blank lines in the separator will not be removed. If you don't want
 a separator, erase the entire contents of this window. If this window is too
 small for your needs, use another editor to format your separator text.  Then
 drag that text (or the file you saved it in) into this window.

 You can include the date and/or time of the append by entering these
 meta-characters in your separator text:

 %d        date (same as %D) using your country's standard format
 %D        date (same as %d) using your country's standard format

 %t        time as HH:MM (plus AM or PM if you use a 12-hour clock)
 %T        time as HH:MM:SS (plus AM or PM if you use a 12-hour clock)

 Separator always on a new line:  checking this ensures that the separator
 always appears on the line following the existing text.  It will not add a
 blank line and will not have any effect if there is no separator.

 New Text
 Controls whether any blank space preceeding the new text will be removed. Null
 characters will always be changed to spaces, regardless of this setting. Your
 choices are:

     remove leading blank lines - lines containing only spaces, tabs, and
      newline characters will be deleted.  The first line containing printable
      text will not be affected.  This is the default.
     remove leading whitespace - all spaces, tabs, and newline characters
      before the first printable character will be deleted.
     do not edit - the dropped text will be left as-is, except for leading
      nulls.

 New text always on a new line:  checking this ensures that the dropped text
 always appears on the line following the separator or existing text.
 Otherwise, its position depends on whether the preceeding text ends with a
 newline character.

 Undo
 restore the settings that were in effect when the notebook was first opened

 Default
 On the first notebook page ("Options for This File"), resets this file's
 options to the system-wide defaults.  On the second notebook page ("DTFile
 Defaults"), resets the options to DTFile's built in defaults. When the
 defaults are already in effect, this button is disabled.

 DTFile Overview
 Changing the DTFile Icon
 Using DTFile Append
 Install/Remove WPS Classes


ΓòÉΓòÉΓòÉ 4.2. DTClip ΓòÉΓòÉΓòÉ

DTClip provides a drag and drop interface for the clipboard.  Registering this
class creates a Clipboard Object on the Desktop that operates like a
DragText-enabled window.  Opening the object displays a window that can be used
as a clipboard viewer and editor.  The window offers an "always visible" option
that keeps it from becoming completely covered by another window.  DTClip
supports only text, not graphics.  DragText must be loaded before you can use
this feature.

For additional information, refer to:

     Using DTClip's Icon

     Using DTClip's Window

     DTClip as a Clipboard Viewer

     Moving and Copying DTClip

     Installing and Removing DTClip

     DTClip Options

 Using DragText
 Workplace Shell Classes
 Install/Remove WPS Classes


ΓòÉΓòÉΓòÉ 4.2.1. Using DTClip's Icon ΓòÉΓòÉΓòÉ

Drag from the object's icon to drag whatever text is on the clipboard.
DragText's standard text or Url icon will appear.  If the clipboard is empty or
contains graphics, DTClip will beep and nothing will be dragged.

Drop text or a file on the object's icon or window to copy it to the clipboard.
By default, the new text will replace any existing text.  To append the dropped
text to the clipboard's existing text, quickly press and release Insert while
over the object or window.

Important:  When dropping text or a file on the object's icon, the mouse
pointer and the dragged image will not change the way they would over a
DragText-enabled window (e.g. DTClip's own window).  However, standard DragText
actions, such as pressing Alt to insert a dropped file's contents, will still
work.

DTClip Overview
Using DTClip's Window
DTClip as a Clipboard Viewer
Moving and Copying DTClip
Installing and Removing DTClip
DTClip Options


ΓòÉΓòÉΓòÉ 4.2.2. Using DTClip's Window ΓòÉΓòÉΓòÉ

Drag and Drop

Drag : To drag the current contents of the clipboard, begin dragging without
highlighting any text;  the window's contents will be updated.  To drag a
selected portion of the text, highlight it, then begin dragging;  the selection
will be dragged and the window will not be updated.

Drop : Dropped text can either replace the clipboard's current contents or be
inserted into it.  Quickly press and release the Insert key while dragging over
DTClip's window to toggle between insert and replace modes.

     In replace mode, the mouse pointer will become DragText's "I-beam with
      X's" pointer.  The dropped text will replace the current contents of both
      the window and the clipboard.
     In insert mode, the dropped text will be inserted into the window's
      current contents at the drop point.  The entire contents of the window
      will then be copied to the clipboard.

 Menu Items

 Copy All : the current contents of the window will be copied to the clipboard.
 Use this after editing the text in the window.

 Paste All : the contents of the clipboard will be pasted into the window,
 replacing whatever is currently in the window. Use this to update the window.

 Options : use the items on this submenu to change the default settings
 established on the Options page of the object's notebook. Refer to DTClip
 Options for a description of each.

 DTClip Overview
 Using DTClip's Icon
 DTClip as a Clipboard Viewer
 Moving and Copying DTClip
 Installing and Removing DTClip
 DTClip Options


ΓòÉΓòÉΓòÉ 4.2.3. DTClip as a Clipboard Viewer ΓòÉΓòÉΓòÉ

When the clipboard viewer option is on, DTClip's window will be updated
automatically whenever the clipboard changes.  This option can be set
independently for each DTClip window you open without affecting the status of
other DTClip windows.

Compatibility with Other Viewers
OS/2 supports having only one viewer window at a time.  When a new viewer is
established, the previous viewer no longer receives update notifications.
However, DTClip and some other viewer apps such as ManyClip are designed to
work around this restriction by forwarding the notification to the previous
viewer.  For DTClip, this is controlled by the "cooperate with other viewers"
setting on the Options page of DTClip's notebook.  When it is checked (the
default), DTClip will forward the notification.

     OS/2 Clipboard Viewer utility - after starting this util, make DTClip the
      viewer.  It will forward notifications to the viewer util.

     ManyClip - ManyClip must always be the primary viewer.  If it is already
      running, click on its window immediately after making DTClip the viewer.
      This will restore ManyClip as the primary viewer and cause it to forward
      notifications to DTClip.

 DTClip Overview
 Using DTClip's Icon
 Using DTClip's Window
 Moving and Copying DTClip
 Installing and Removing DTClip
 DTClip Options


ΓòÉΓòÉΓòÉ 4.2.4. Moving and Copying DTClip ΓòÉΓòÉΓòÉ

To copy, move, or shadow the object itself, have Ctrl and/or Shift pressed when
you begin to drag.  Once DTClip's icon has begun to move, you can release these
keys, if desired.  You can also move or copy the object by:

     using its menu options
     selecting other objects to be moved or copied at the same time
     performing these actions before DragText is loaded

 DTClip Overview
 Using DTClip's Icon
 Using DTClip's Window
 DTClip as a Clipboard Viewer
 Installing and Removing DTClip
 DTClip Options


ΓòÉΓòÉΓòÉ 4.2.5. Installing and Removing DTClip ΓòÉΓòÉΓòÉ

DTClip can be installed or removed either by using the DTSetup program or by
opening DragText's Options notebook to the Extended page and pressing the
button next to DTClip.

Each time you install DTClip, a Desktop object will be created; its WPS ID is
"<DT_CLIP>".  Removing DTClip will explicitly delete this object.  Copies of it
will not be deleted and may reappear if you later reinstall DTClip.

If you need to recreate the Desktop object (e.g. you accidentally deleted it),
simply remove the DTClip class, then install it again.  Restarting your system
is not necessary.

DTClip Overview
Using DTClip's Icon
Using DTClip's Window
DTClip as a Clipboard Viewer
Moving and Copying DTClip
DTClip Options


ΓòÉΓòÉΓòÉ 4.2.6. DTClip Options ΓòÉΓòÉΓòÉ

These options are set from the first page of a DTClip object's WPS notebook.
They apply to the window(s) displayed when you open the object.  Most are
defaults that can be changed for a particular window from its Options submenu.

word wrap
This can be changed from the Options submenu.

keep window visible
whenever the text area of the window becomes completely covered, it will place
itself on top of all other windows.  If it is only partially covered, it will
not move.  This can be changed from the Options submenu.

check visibility
controls how often the DTClip class should check to see if any of its windows
are covered.  This is a global setting that affects all windows for all DTClip
objects.

clipboard viewer
when enabled, the window will automatically be updated whenever the contents of
the clipboard changes.  This can be changed from the Options submenu.

cooperate with other viewers
if another clipboard viewer is active when DTClip becomes the viewer, DTClip
will forward update notifications to the previous viewer when they are
received.  If both DTClip and the other viewer start updating their windows
continuously, turn this off.

Undo
restore the settings that were in effect when the notebook was first opened

Default
use DTClip's built in default settings.  When they are already in effect, this
button is disabled.

DTClip Overview
Using DTClip's Icon
Using DTClip's Window
DTClip as a Clipboard Viewer
Moving and Copying DTClip
Installing and Removing DTClip


ΓòÉΓòÉΓòÉ 5. About DragText ΓòÉΓòÉΓòÉ

                            - DragText version 2.0 -
                       The Drag and Drop Enabler for OS/2*

                       (C) Copyright R L Walsh 1994 - 1996
                              All rights reserved.

                                    write to
                               [e-mail]
                                    -- or --
                                   Rich Walsh
                                315 S. Barbour St
                          Beverly Hills, Florida 34465
                                     U.S.A.

                              Registering DragText
                                License Agreement

* OS/2 and Presentation Manager are trademarks of International Business
Machines Corp.


ΓòÉΓòÉΓòÉ 5.1. Registration ΓòÉΓòÉΓòÉ

To keep DragText's Extended features from becoming disabled after your 6-week
free trial ends, register it directly with the author or through BMT Micro.
You will receive a registration number to enter on the last page of the Options
Notebook.

Direct  - $15 - $20 (US)

The author can accept checks or money orders drawn in any stable major
currency.

     U.S. Dollars:  registration is $15 if the check is drawn in US dollars on
      a bank in the United States.  Some users in western Europe have
      successfully sent me cash, but this was done entirely at their own risk.

     Other Currencies:  registration cost is the equivalent of $20 converted
      into your national currency.  The additional cost covers my bank's fee
      for automated processing.  Your check will not be accepted if it converts
      to significantly less than $20, or if my bank requires it to be processed
      manually.

      You can determine the exchange rate by asking your bank or looking in the
      financial pages of your local newspaper.  There are usually separate
      "buying" and "selling" rates.  Please use the rate that is less
      favorable to you (i.e. will cost you more) because that is the rate I
      will get when I cash your check.

      If you have any questions, email me before sending your payment.

 Mail your check or money order to:
           Rich Walsh
           315 S. Barbour St.
           Beverly Hills, Florida  34465
           U.S.A.

 Include your full name, mailing address, and email address (if available).
 Send email to:  [e-mail]

  BMT Micro  - $18 (US)

 Phone:         8:00am - 7:00pm EST (-5 GMT)
                [phone] (Orders only)
                [phone] (Orders / Order Inquires)

 Fax:           [phone] hours, 7 days a week
                [phone] 24 hours, 7 days a week

 BBS:           [phone] 10 lines, all 14.4K
                [phone] 28.8k v.FC

 Internet:      [e-mail]

 Compuserve:    Thomas Bradford, 74031,307

 telnet:        bmt.wilmington.net

 BMT Micro accepts Visa, Mastercard, Discover, American Express, Diner's Club,
 money order, cashiers checks, and personal checks. They also accept DM and
 British currency via registered mail. Personal checks are subject to
 clearance.

 BMT Micro accepts purchase orders from educational institutions, governmental
 agencies and other verifiable businesses.  Terms are "Due Upon Receipt" with a
 $250 minimum.

 Entering your registration number
 Product Information
 License Agreement
 Options Notebook


ΓòÉΓòÉΓòÉ 5.2. License Agreement ΓòÉΓòÉΓòÉ

DragText, its executables and documentation, is the copyrighted property of
Richard L. Walsh. It is licensed, not given, to you for your personal use.
Selected features require the payment of a registration fee for continued use.

You may copy and freely redistribute DragText to others, provided:
        -  the recipient agrees to the terms of this license,
        -  you transfer DragText as a whole and intact,
        -  there is no cost to the recipient other than the costs of providing
           media and transmission, and
        -  it is not redistributed in conjunction with any software that may
           not also be freely redistributed by the recipient.

 You may not modify DragText in any way nor may you reverse assemble, reverse
 compile, or otherwise translate or reverse engineer its executable code or
 data. You may make additions to the documentation, including translations into
 other languages, provided these are contained in files separate from the
 originals and are identified as addenda to the accompanying original
 documentation.

 DragText is not warranted to be free of defects nor to be suitable for any
 particular purpose the licensee may put it to. The licensee agrees to use
 DragText at his or her own risk, and agrees to accept all liabilities arising
 from its use, including all claims by third parties, without recourse to the
 author or copyright holder.

 THERE ARE NO WARRANTIES, EXPRESS OR IMPLIED, OF ANY SORT. BY YOUR USE OF THE
 PROGRAM YOU AGREE TO THE TERMS OF THIS LICENSE.

 Product Information
 Registering DragText
 Options Notebook